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GENERAL DESCRIPIION 


SYSTEM/ELOGOUT is a system utility prograws designed to anatyze 
the Field Engineering Maintenance Log CSYSTEM/ELCQG) and produce 
Organizeds meaningful reports of the results. Errors are 
reported in chronological order by unit-anesonices with 
appropriate totals summgarized at the end of the output listinge 


RELATED DOCUMENTATION 


Name a _ Nusber 


B1800/81700 Software Operational Guide 1068731 


BURROUGHS CORPORATION | -_ COMPANY CONFIDENTIAL 


COMPLTER SYSTENS GROUP | BL B007B1700 SYSTEM/ELCGOUT 


SANTA BARBARA PLANT | : | | Te Pe Se 2222 2673 (3B) 


“OPERATING INSTRUCTIONS 


The ‘ET input message is used to transfer the SYSTEM/ELOG- file>» 


creating a file labeled “*"ELOG/&<integer>* and a new Ceapty) 


SYSTEM/ELOG file. SYSTEM/ELOG ts executed automaticalty by the 


“HCP following the transfers and ais fitle-equated to the 


transferred elog fite. 


If it is necessary to analyze a previously-trans ferred ‘aioe eee 
SYSTEM/ELOGOUT sust be executed as follows: 


EX SYSTEN/ELOGCUT FI ELOGeFILE NANE= ELOG/ #<integer>s 


PROGRAM SHIICHES 
The program switches contrctl certain functions of SYSTEM/ELOCOUT. 


- SHITCH 9 


Switch O» if set to a nonzero values causes the input elog file 
to be closed with PURGE after the input phase has been completed. 
If switch 0 is set to zero (the default value)» the input elog 
file witl not be removed from disk. The setting of switch 0 has 
no effect if SYSTEMZELOG is being analyzeds since the active elog 
fife cannot be removed frogs disk. 


SHIICH 1 | | | 
Switch l» if set to a non-zero values causes the entire output 
Listing to be single-spaced» suppressing all page skipping and 


euitiple spacing operations. If switch 1 is set to zero (the 
default value)» the default printer spacing will be emptoyed. 


LORTORDER SHITTCHES 


The low-order procgrarm switches may be used to specify the systen 


seriat number» as shown below: 

MOCTFY SYSTEM/ELQGCUT SW=<systesm nuaber> 
If the systen serial nuater is spectfieds it will be printed on 
the first pace of the cutput listing. tf wt is necessary to 
specify the system seriat number as wetl as other functions» the 
sertai number must be specified first in the controt string. 


HODIFY SYSTEM/ELOGOUT SW=513 SWO=1 SWi=1 
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“DESCRIPTION OF OUTPUT 


A number of reports are produced by SYSTEM/ELOGOUT> providing a | 
detaited analysis of errors by unit and hardware type. The 
output of these reports is described in the following paragraphs. 


SYSIEM INFORMATION REPORT 


The first portion o f the output Listing produced by 
SYSTEM/ELOGOUT consists of information describing the system and 
the elog file being analyzed. Inforgwation printed inctudes the 
system serial nunber (Cif one was specified in the progran . 
Switches )» plus the name and period of time covered by the elog 
file being analyzed. 


The dates and times of ail Clear/Starts (Cif any) that occurred 
during the period of time covered by the elog file are tisted in 
the order they occurrede 


A description of the systew 1/0 configurations listing each 
hardware device together with its unit mnemonic» device-id 
Ccontrol-id in hexadeciwal)» and hardware address (ooert/channeil )>» 
-#s inctuded at teast once if a Clearc/Start occurred during the 
pertod of time covered by the elog being analyzed. Additional 
descriptions are printed for each Clear/Start where the I/0 
configuration was different from . that at the previous 
Clear/Start. Note that the systers 1/0 configuration descrigtion 
does not include any dataccmm devices or controis. | 


A description of the systes softwares being used is included at 
least once if a Clear/Start occurred during the period of time 
covered by the elog being anatyzed. Additiorat descriptions are 
printea for each Clear/Start where the software OES ur scvoN was 
different from that at the pEeyeous Clear/Start. 


Note: The 17/0 Conficuration and Software Configuration reports 
|  eannot be produced if no Ciear/Starts occurred during the 
period of time covered by the etog file being anatyzed. 
The information recuired for these reports is only placed 
in the elog file by the MCP during the Ctlear/Start 
operation. | 


QORERATCR MESSAGE REPORT 


Messages entered in the elog by the systenrn operator (Crefer to the 
EM input message in the 81800/81700 Software OQperationat Guide) 
are listed chronologically» together with the date and time of 
entrye os 
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 -NEMORY ERROR REPORT 


Mewory parity errors for 81830 sad 81700 ‘setses are tlisted in 
chronologicat orders if any were detected. The report produced 
includes the date and time of the failures the job nusber of the 
programa that was terminated together with tts base and Limit 
addresses» and the address of the parity error. If the parity 
ercor couid not be located by Gismo (possibly indicating a read 
out-cf-bounds error by the program)» the parity address wilt be 
“FFFFFFS. | 


The report produced for the 81870/81860 systeas differs stightty 
due to the use of error-correcting memory. It includes the date. 
and time of the errors the hexadeciaal representation of the 
processor elog register (which reports the memory error te the 
software) and the decoded representation of this register. This 
decoded information enables the Field eng nees to quickly isotate 

and repair the failure. 


CONSOLE CASSETIE ERROR REPCRT (81800 ONLY) 


This report. is produced if any data errors are detected during 

prograzmatic loading of a cassette through the cassette reader in 

the 81800 system console (Ceegus With SYSTEM/LOAD.CAS)» and 

includes the date and time of the errors the job nuzber of the 

 prograg reading the cassette» and the program's base and Limit 
addresses. : 


UNIT ERROR REPORT 


Peripherat unit errors are reported and summarized by 
unit-mnemonic ands where muitiple controls are connected to the 
Same unit Cesger a PESNRZ tane exchange)» by hardware address. 
Each error reported on the unit is tisted chrconologicalilys 
together with the date and time of the errors the result 
descriptor in hexadecimal» the 1/0 op code and its mnemonic 
description (R=read» wW=write» S=space)» the disk address (disk 
devices onty)>» the data tength Cin bytes) requested in the 1/0 
descriptors the actuai tensth Cin bytes) of the data transferred» 
the number of retries atteapted (Ceften shown as zero for MCP 
operationss even though retries are actually attempted)» the job 
number of the program encountering the error» the tabel of the 


file Calways the pack-id fer disk devices)>, the serial number 
(for tapes and disk packs/cartridges)» the reel rumber Ctapes 
only)» and the Extended Resuit Oescriptor Cif any). If an 
‘Extended Result Cescriptor is present» it #s decoded on the 


foilowing tines tnto tts alphanumeric description. 


Following the chronological error Listing» an analysis of the 
resutt descriptors ts tisted. The result descriptors are tisted 
in hex (6 digits) and binary (24 digits) together with a- 
description of the error. Each result descriptor is. listed once 
in-the summary» cregardless of the nusbder of times it may have 
@ccurred in the elog. = 
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For disk devices» an additional report anatyzes the errors by 
disk address» sorting in ascending order and susmarized by 
address and actual data transfer tength Cin sectors). Each line 
presents the errors for a particular disk address and actuat 
length pairs giving the total number of retries (retry ccunts 
shown as zero in the chronological tisting are counted as one 
tetry)» and decoding the beginning and ending disk addresses 
involved in the operation into their hardware locations. This 
decoding can enable tha Field Engineer to tocate not onty the 
source of the failures but also to make reasonable inferences as 
to errors that may be caused by a singte read/write head» even 
though the addresses may be widel Scattered across an entire 


disk surface. | 


UNIT ERROR SUMMARY 


The final report produced summarizes the peripheral unit errors 
Listed in the Unit Error Reports» providing totals for each 
unit-mnemonic (Canc hardware addresss if applicable). For each 
device listed» the total errors occurring on ingut (read = and 
$pace operations) and outout (write operaticns)» as welt as the 


total number of memory access errorss are presented in tabular 


fora. 
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ERROR MESSAGES 
If SYSTEM/ELOGOUT analyzes an elog file and finds no records in 
it» the program wilt dispiay the following message and gc to 
end-c f-job. | | 


<elog-file-id> EMPTY 
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